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Preface to darktable 



The current user manual is a draft issue. It is at an early stage of writing. User manual version and applicable 
Darktable version are listed below: 

version date 

user manual 22/10/10 

Darktable darktable 0.6+408~gdd52b32 22/10/10 



Chapter 1 . Overview 



Darktable is an application to manage and develop your digital images... 



Preferences 

1. Preferences 

A recently introduced button located at the upper panel allows you to define various parameters. 



User interface 



2. User interface 



This section describes the layout of the user interface. You can change 
Darktable contrast by using /7 and/8. 



2.1. Views 



Darktable consists of several views also mentioned as modes. For the time being, there are three available views 
as described in this section. The current view is identified by the label at the top of the right panel. Some key 
accelerators, allowing to access the different views, are described in the table below: 

/ switches to lighttable view 

d switches to darkroom view 

t switches to camera tethering view 

2.1.1. Lighttable 

The lighttable view is where you manage your images and filmrolls; it's in that view that you rate, add tags, add 
colorlabels, export images among other actions. 

2.1.2. Darkroom 

In the darkroom view you develop a specific image using the available modules. 

2.1.3. Tethering 

This view is where you do camera tethering. 

2.2. Filmstrip 

The filmstrip shows the same images as lighttable with respect to filter and sort orders and are turned on/off with key 
accelerator ctrl-f. You can navigate along the filmstrip by wheel scrolling. The filmstrip allows you to interact with 
images when you are not in lighttable mode. For example you can, while being in darkroom mode and developing 
an image, switch to another image to develop by double clicking the thumb in the filmstrip. 




The filmstrip also provides some actions to be performed on image under the mouse pointer and here follows a table 
of available key accelerators for specific actions. 

1-4 set the rating of the image; if an image has 1 star and you hit the 1 key the image will be 

unrated 

Fl - F3 set a color label for the image 

ctrl-c copy the history stack of the image 

ctrl-v apply the copied historystack onto the image 



Darktable workflow 



3. Darktable workflow 

3.1. Importing images 

To begin with Darktable, you first need to import images. You can either import from your filesystem or from your 
camera if supported. 

3.2. Importing from camera 

3.3. Exporting images 



Chapter 2. Lighttable 



The lighttable is where you manage all your images, ratings, exporting and much more... 




Overview 



1 . Overview 



1.1.Lighttable 



In this centerview, your images are shown as thumbs; each thumb has a frame 
and while mouse is over an image, the information of rating, colorlabels and 
if image is altered in darkroom is shown. Also when mouse hovers over an 
image frame the specific image metadata is shown in the metadata panel. 




In able to locate where you are in your collection, you have read-only sliders at the extreme border of the window : 
left/right for your vertical position in the collection, top/bottom (when in zoomable lighttable mode, see below) 
for your zoom level. 

While mouse is over an image frame, you have additional actions accessed from keyboard to apply on image; here 
follows a table of key accelerators and assigned actions. 



1-4 

Fl -F3 

ctrl-c 
ctrl-v 

e 

z 



set the rating of the image; if an image has 1 star and you hit the 1 key, the image will be 
unrated 

set a color label for the image 

copy the historystack of the image 

apply the copied historystack on the image 

open the image in darkroom view for developing 

show a fullscreen view of the image 



At the bottom you have an option to choose between zoomable lighttable view or filemanger view of the thumbnails. 

Using the zoomable lighttable view, scroll with your mouse wheel to zoom in and out. The hold left-click allows 
you to navigate through your collection. 

While in filemanager you can use ctrl-(mouse wheel) to change the number of thumbs displayed in a row. That 
action is a key accelerator of the counter that can be found beside the filemanager option. Use your mouse wheel 
to navigate through your collection. 

By pressing a/s/d/w you can navigate through your collection 

1.2. Filtering and sort order 

The filtering and sort order of images on lighttable are accessed and changed in the top bar where you can select 
among a few predefined filters and ordering like date, color labels, rating among others. 



Panels 

2. Panels 
2.1. Devices 

This module shows connected devices; for now only cameras are shown up there, but in future scanners too will. 

2.1.1. Cameras 

When a camera is detected, it will show up in the device panel; if you hover your mouse over the camera tab label 
a tooltip will pop up with some information about the camera such as model, firmware version and a lot more... 

Depending of the support of your camera, buttons with actions will be available such as import images and tethering. 

Import images 

This will bring up an import dialog, showing the images on camera that can be selected for import into a filmroll 
in Darktable. 



Tethering 



Tethering is used to integrate Darktable with your camera. While you take images with your camera, they will 
automatically be imported into Darktable so you can review the result of the shoot. You can also setup remote 
capture jobs, controlling number of images and time between captures along with camera settings such as exposition 
time, f-length and more. 

If supported by your camera, tethering will take you into capture view for tethered shoot. Read more about tethering 
in chapter 3. 



2.2. Library 



In library, you import and remove your filmrolls. You can either import a complete folder by pressing 'import 
filmroir or a single image 'import single image'. 

A filmroll is the same as a folder in the filesystem, except for 'single images' filmroll that contains images spread 
among your filesystem. You can import a single image or a folder; if a folder is imported, Darktable will not recurse 
down in several folder levels but it will just import the images that resides inside the chosen folder into a filmroll 
whose name becomes the name of the imported folder. 

Importing a folder does not mean that Darktable copies your images in another folder. It just means that the images 
are visible in lighttable and thus can be developed. It means that if you delete an image/a folder after having imported 
them, Darktable will not be able to access them anymore. Importing an image/folder in Darktable is not a backup of 
your filesystem! Moreover Darktable does not currently watch changes in filesystem. Thus if on your filesystem you 
add an image after having imported that folder in Darktable, the new image will not be shown until you explicitely 
import it. 

All your filmrolls are available in a list which can be filtered using the editbox to fast find the filmroll of interest. 
Double click on a filmroll in the list and it will open. You can also click the recent filmroll items to open the latest 
ones you have worked with. 



2.3. Metadata 



This panel shows embedded metadata of an image, read 
from EXIF data stored in your pictures files. 



» metadat 


a 


filename 


20100905 0250. NEF 


model 


D90 


maker 


NIKDN 


aperture 


F/11.0 


exposure 


1/320 


f-length 


24 


iso 


200 


date/time 


2010:09:02 07:08:00 


lens 


24-70mmF2.3 


width 


2868 


height 


4310 


film roll 


20100905 -Rhodos - 2010 



Select 

2.4. Select 



This panel allows to quickly select images, according to 
various criterion. 




select all 

Select all images in the current view (collection), with respect to filters. 
select none 

Select no image. 
invert selection 

Select all images that are not currently selected. 
select film roll 

Select all images that are in the same filmroll as the currently selected images. 
select untouched 

Select all images that has not been developed yet. 

2.5. Selected image(s) 



This panel allows to perform some actions on selected 
images. 



» selec 


ted image[s] 









remove 


delete 




i 




write dt files 


duplicate 




c 








) 


reset rotation 
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remove 

Remove the selected images from the Darktable database. Those images will not be shown in lighttable anymore, 
but remain on filesystem. 

delete 

Physically delete selected images from filesystem. 
write sidecar files 

Write .xmp sidecar files. 

duplicate 

Create a virtual copy of selected images within darktable but not physically on your filesystem. It allows to test and 
try different developments for the same image for example. 

rotation 

Perform a counter-clock wise/clockwise rotation on selected images. The third button allows to reset rotation to 
EXIF value. 



History stack 



2.6. History stack 



This panel allows to manipulate development. For each 
image, development is written in a sidecar file (.xmp) and 
is fully non-destructive. 




copy 

Copy the history stack (development) of the first selected image. 
discard 

Physically delete the history stack (development) of the selected images. Beware, this action can not be undone! 

overwrite/append 

Describes how a new history stack must behave if pasted on an image having already an history stack. 'Overwrite' 
will delete previous history stack whereas 'append' will add the two history stacks. 

paste 

Paste a previously copied history stack on another image. 

load sidecar file 

Prompt a dialog box to allow you to select a .xmp file, thus loading an history stack that you will past (thanks to 
'past' button) on images. 

2.7. Tagging 



This panel allows to manage tags for your images. Those 
tags are currently stored in sidecar files (.xmp) and within 
the darktable database for a faster access. The panel is 
divided into two parts: the upper part contains the tag(s) 
currently set for the image either under mouse (if mouse 
is over an image) or selected (if mouse is outside the 
lighttable). The lower part contains all tags available; 
those can be filter thanks to the upper text box. 




attach 



detach 



Attach the selected tag(s) from the list below to all selected images. 



Detach selected tag(s) from the list above from all selected images. 



new 



delete 



Create a new tag for the list. 



Delete a tag from the list. 



Collect images 



2.8. Collect images 



Thanks to this panel, you can manage your collection 
(current view) by filtering image thanks to various 
criterion. The left combo box lets you choose from 
different filters, such a 'filmroll', 'history stack', 'date', 
'camera' and much more. The table belows lists all 
available data for the selected filter. You can then select 
the data of your choice by double-clicking. 




2.9. Export selected 



Each workflow has to end by this panel: the exportation 
of your developed images. Currently, you can export 
either to a file on your disk, or to various on-line storages. 
TIP: you can use Ctrl- alt- e to export. 



export selected 



target storage 



S ( Fl LE_DI RE CTORY )/d a rtcta b I e_e *p o rte d/i mg_$ ( S □ 



quality < 



global options 



ma* size 
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Chapter 3. Darkroom 



The darkroom view is where you develop your image... 
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Overview 



1 . Overview 



In darkroom you are in develop mode for the specific image; here you have a lot of tools (named module) to develop 
you image. 

On the left side you have the navigation, snapshots and history panels, each of them being described below; in the 
right panel you can see the histogram and then a list of available modules to use when working with your image. 
At the bottom of the right panel you can enable/disable view of individual modules. 

Since darktable 0.6.1, modules are grouped into four groups: basic, color, correct, effect. However, you can view 
all modules by selecting no group. 

For those interested in how it works, modules are applied on images following a bottom-to-top order. That means, 
that if you activated the view of all modules (by selecting no groups), the first module to be applied will be "import 
a RAW" at the bottom of the right panel, whereas the last one will be "splittoning" at the top of the right panel. That 
order can not be changed by user, so modules are always applied following the same order. 
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Filmstrip 

2. Filmstrip 

The filmstrip is used to quickly switch between image to develop in darkroom view, the images viewed are the 
same as the ones in the lighttable view. 

The filmstrip can be switch on and off using ctrl-f shortcut. 



13 



Panels 



3. Panels 

3.1. Navigation 



This panels shows the whole image and a rectangle is 
showing the current zoom view that you see, you can 
move this rectangle to pan around in same zoomlevel. 




3.2. Snapshots 



You can take a snapshot of what is displayed in the center 
view; this snapshot can then be selected and is overlay ed 
in the current center view to help you with a side by side 
comparasion (left: snapshot, right: active) when you are 
tuning parameters of a module. In the active view, history 
remains usable in order to compare with the snapshot. 



» snap 
20100 


5hQ- 

9Q5_ 


ts 
_025C 


1(6) 




20100 


9Q5_ 


_Q25Q(2) 










take 


snapshot 


1 



3.3. Metadata 



Shows the metadata for an image, same as in lighttable mode. 



3.4. History 



The historystack lists every change of state (activate/de- 
activated) for all modules. Here you can select a point 
in stack to return to that point of development history. 
If you then activate a new module, all modules above 
the current point will be discarded. Hitting 'compress 
historystack' generates the shortest historystack that 
produces the current image, i.e. suppressing all de- 
activated modules. 



▼ history 



■ tone curve Con) 

■ base curve (on) 

■ highlight reconstruction (off) 



2 - sharpen (on) 

1 - crop and rotate (on) 



- original 




compress history stack 









3.5. Histogram 



Show a logarithmic histogram of the developed image; 
you can change exposure by left mouse click in the right 
side of histogram and drag right for increase or left to 
decrease the exposure. The same goes for the black level 
but you left click in the left part of histogram. 
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Modules 



4. Modules 



Each correction, enhancement or effect is implemented as modules, and this section includes 
documentation of each module and its specific parameters. A module consists of an expander bar 



fh ^ 5- harp* 



I where the MM icon is used to turn then module on or off, then 

there are a title of the module press this to expand the module to see the parameters user interface. H icon is the 

preset icon to access the available presets stored for the module or to create new ones. The W icon is used to reset 
the module parameters to their default values. 

4.1. Interacting with modules 

For each slider, you can interact in three different ways, depending on the level of control you need. 

1. Arrows 

You can use the arrows around the slider to control precisely the increase/decrease of the value. 

2. Mouse wheel 

Hover a slider with your mouse, then use your mouse wheel to adjust by step the value. 

3. Right-click 

Your mouse being over a slider, right-click gives you numerical access the slider values. Note that the numerical 
value needed to be entered is sometimes different from the one displayed. For example, the percentage repartition 
is displayed as X/Y (eg 70/30) but numerical value to be entered is -1 for 0/100, for 50/50 and 1 for 0/100. 

4.2. Presets 

Presets are stored configurations for the module parameters both internal and user-defined is available through 

clicking the H icon and a list of available presets are shown for your choice, the activated preset is in bold text. 

The preset system does also support automatic preset selection based on image data such as focal length, iso, camera 
model and much more fields. 

4.2.1. Creating a new preset 

Configure the specific module of choice as you like then you click the H icon and select store new preset menu 
choice. Following dialog will be shown to configure the preset: 




The first two fields are used for setting a name and a description of the preset. 

In the example i have also checked the auto apply option which brings up the image selection fields where you can 
define a filter that is used to decide if the preset should be applied the image or not. The example dialog above does 
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Raw import 



set up following rules, if lens name matches and aperture is >= 8 and focal length is in range 24 - 35mm the preset 
will be automatically applied, it will also only show in the preset list if the image does match this rule. 

The data used is the EXIF information so if you want a preset to be applied to all images from a specific camera, 
then leave all fields at default values, lookup model string in metadata panel and enter it into the model field. 



4.3. Raw import 
4,3.1. Overview 



This module in the first module in the pixelpipe for RAW 
images. 



▼ raw import 

warning: these are cry 
you probably don't ha 1 
median passes 

demosaic method 
reset 


ptic low levi 
je to changi 


SO 

el settings! 
e them. 





■ 


PPG 


¥ 


Q hot pb« 

Q green e 


5t5 

iquilibration 


re 


-import 







4.3.2. Usage 

4.4. Exposure 
4.4.1. Overview 



This module is used to tweak the exposure. It is 
directly linked to the histogram panel. Indeed, if 
you correct exposure graphically, using the histogram, 
you automatically activate the exposure module. The 
histogram simply acts as a view for the exposure module. 




4.4.2. Usage 
black 

Adjust the black level. 
exposure 

Adjust the exposure correction [ev]. 

auto 

Calculate a correct exposition for the rectangular view appeared in the centre of the image. You can draw your own 
zone using your mouse. 

4.5. Denoise 
4.5.1. Overview 



This module is used to denoise high iso pictures. It 
is flagged as a slow module due to its high resources 
consumption. Depending of your hardware, this module 
can currently slow down Darktable or even crash it. Quite 
counter-intuitively, the greater the values for sliders, the 
lesser resources. 
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White balance 



4.5.2. Usage 

radius 

Set the spatial extension of the gaussian blur. 
red 

Blur intensity for red channel. 
green 

Blur intensity for green channel. 
blue 

Blur intensity for blue channel. 

4.6. White balance 
4.6.1. Overview 

This module is used to set the white balance. You 
have 3 ways to interact with it. Either you set up tint, 
temperature in and temperature out. Or you define the 
value of each channel. Or you can choose predefined 
white balances. 




4.6.2. Usage 

temperatures 

Set the tint, temperature in and temperature out (in Kelvin). 
channels 

Set the channel values on a scale from to 5. 

predefined values 

You can choose between various predefined white balance. You can choose your camera white balance. A spot 
white balance is also available, using a zone you can draw with your mouse. 

4.7. Highlight reconstruction 

4.7.1. Overview 

This module tries to reconstruct color information that 
is usually clipped because of the information being not 
complete in all channels. If you do nothing, your clipped 
areas are often toned to the not clipped channel. For 
example, if your green and blue channels are clipped, 
then your image will appear red in the clipped areas. 

4.7.2. Usage 

You can choose between two methods: clipping highlight or blending LCh. 
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Graduated Neutral Density 



Clipping highlight 



Clipping highlight analyses each pixel having at least one channel clipped. Then it sets all channels to the minium 
value found among the channels. 

Blending LCh 

Blending LCh analyses each pixel having at least one channel clipped and transforms the information in LCh color 
space to linearly mix the channels. 

4.8. Graduated Neutral Density 
4,8.1. Overview 

This module aims at simulating a neutral density filter, 
in order to correct exposure and color in a progressive 
manner. 




4.8.2. Usage 

The module uses a gradient to modify the exposure and the color cast of the image in a non-homogeneously manner. 



density 



ND 


[ev] 


or 


f-stop 


absorbance 


ND2 


-1 






0.3 


ND4 


-2 






0.6 


ND8 


-3 






0.9 


ND400 


-9 






2.7 


compression 











Set the density of the filter in [ev] . A low value underexposes slightly whereas a high value creates a strong filter. 

It is expressed as [ev] that is equivalent to f-stops. Lens filters are often referred as ND2, ND4, ND8 and so on. 
Each time you add an [ev] you double the ND. So ND2 is 1 ev, ND4 is 2 ev, and so on. You can also express it in 
optical density or transmittance. The table below sums up the different approach for the most common filters: 

transmittance 
50% 

25% 

12.5% 

0.195% 



Set progressiveness of the gradient. A low value creates a smooth transition, whereas a high value makes the 
transition abrupt. 



Set split to offset the filter, i.e. to move the transition zone above or below the centerline. Expressed as a percentage, 
values above 50% set the transition zone above the centerline. 



Set the rotation so the gradient acts along an axis different from the vertical one. Expressed in degrees, negative 
values turn clockwise. 

hue 

Set the hue to add a colorcast to the gradient. 
saturation 

Set the saturation to add a colorcast to the gradient. 



split 



rotation 
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Basecurve 



TIP: If you know you intend to use the GND filter before actually making a shot with your camera you might want 
to underexpose by one or two thirds of an f-stop to make sure detail remains in the highlights. When all detail has 
truly been blown out the GND filter cannot produce a pleasing results, this is a limitation that is inherent to digital 
postprocessing. For instructions on how to intentionally underexpose, please consult your camera's manual, look 
for 'exposure compensation'. 



4.9. Basecurve 
4,9.1. Overview 



Darktable comes with general enhanced basecurve 
presets for several models that is per automatic applied 
to raw images for better colors and contrast. 




4.9.2. Usage 



The basecurve works in camera linear RGB. You can click on any point on the curve and drag to adjust; you can 
also use the 4 controlpoints (triangles which have a constant vertical value) at bottom to adjust the curve. 



4.10. Lens correction 
4.10.1. Overview 



Lens correction.... 




4.10.2. Usage 

4.11. Unbreak input profile 
4.11.1. Overview 



This module allows to correct an input profile. 
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Input color profile 



4.11.2. Usage 

linear 

Set the linear value. 
gamma 

Set the gamma value to correct your input profile. 

4.12. Input color profile 
4.12.1. Overview 

This module sets up the input color profile. 



T input c 

intent 
profile 


Dior profile 




= 


perceptual 




¥ 


standard colo 


r matrix 


T 









4.12.2. Usage 

intent 

Set intent to use for input profile. As a reminder, the intent is the way Darktable will deal with out-of-gamut colors. 



perceptual 

relative 
colorimetric 

saturation 

absolute 
colorimetric 



Suited to pictures. It scales one gamut to fit into the other while maintaining the relative 
position of colors. 

Out-of-gamut colors are converted to colors having the same lightness, but different 
saturation. Other colors remain unmodified. 

Saturation is kept but lightness is slightly changed. 

Keep the white point. 



profile 



Choose the color matrix to apply. Darktable offers many widespread profile along with an enhanced matrix 
processed by Darktable team in order to provide a look close to the manufacturer one. 



4.13. Color transfer 
4.13.1. Overview 



This module allows to transfer on an image the colors 
found on another. 




4.13.2. Usage 

number of clusters 

Set the number of color clusters to use. 
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Equalizer 
acquire 

Acquire the colors of the current image. 
apply 

Apply the colors (shown above) previously acquire on another image, on the current image. 

4.14. Equalizer 
4.14.1. Overview 



This module is an equalizer based on edge-avoiding 
wavelets. It allows to smooth or enhance details by acting 
on luminance frequencies and multiplying them by a 
factor. 



▼ equali2er = Q> 


< 








































O luma £ chroma 



4.14.2. Usage 



Low frequencies are on the left, high frequencies on the right. The vertical scale represents a multiplying factor. 
Low frequencies represent wide homogenous areas, whereas high frequencies are small details. 

By default, the user sees a straight line with factor equal to 1 , meaning that no frequency is changed. To sharpen, you 
can draw a line going up from the low frequencies to the high ones. On the contrary, if you want to attenuate, just 
draw a line going down. You can change the area of influence by mouse scrolling. Moreover you can act separately 
on the luminance or the chrominance values. 



4.15. Monochrome 
4.15.1. Overview 



This module is a quick way to convert image in black and 
white. You can simulate a color filter in order to modify 
you conversion. That filter can be changed in size and 
color center. 



o 



4.15.2. Usage 

You can change the filter size by using the slider below the diagram or directly with mouse scrolling above it. 
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Zone system 



4.16. Zone system 
4.16,1- Overview 



This module is another way to change the lightness of 
your image. It is based on the Ansel Adams system. 
It allows to modify the lightness of a zone taking into 
account the effect on the adjacent zones. It divides the 
lightness in an user-defined number of zones. 




4.16.2. Usage 

The lightness is processed on the L* channel from CIELAB. 

The center view shows the image broken down in zones. 

When hovering above a zone on the lightness scale, the current zone is highligthed on the preview. The number of 
zones can be changed by mouse- scrolling on the lightness scale. 

4.17. Tonecurve 
4.17.1. Overview 



This module is a classical tool in digital photography. 
On the horizontal line is represented the lightness of the 
image pixels. The vertical line represents the lightness 
of the result image pixels. Thus, a straight line does 
not change anything. A point above the default diagonal 
increases the lightness whereas a point under decreases 
it. 




4.17.2. Usage 

The tonecurve works on Lightness channel only. 

The horizontal axis is split in 5 zones thanks to 4 triangles. Those triangles have a constant vertical value, thus 
moving them modifies the curve so their output value is kept. 

When your mouse hovers the curve, brighter zone are shown to visualize the degree of liberty you have without 
damaging too much your image. 
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Relight 



4.18. Relight 
4.18,1- Overview 



This module allows the local modification of the 
exposition based on pixel lightness. 




4.18.2. Usage 

The module applies a Gaussian curve to the lightness, centred on a given lightness, with a given width in lightness. 
exposure 

Set the fill-light exposure in [ev] . 

center 

Set the median lightness being impacted by the fill-light directly on the gray scale or by using the button on the 
right and then selecting an area in the image. 



width 



Set the width of the Gaussian curve. It is expressed in zone, the whole dynamic being 10 zones. The Gaussian being 
symmetric, only even numbers can be entered. 



4.19. Color zones 
4.19.1. Overview 



This module allows to selectively modify the colors 
in your image. It is highly versatile and allow every 
transformation possible in the LCh colorspace. 




4.19.2. Usage 



The horizontal axis represent the different values you can modify. The vertical axis shows the changes you can 
achieve. 

For both horizontal and vertical axises you can work on Luminance (L), Colorness (C) or hue (h). As a reminder, 
colorness is a notion close to saturation but changing colorness does not change the perceived lightness as saturation 
can do. 
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Color correction 



4.20. Color correction 
4.20.1. Overview 



This module can be used to modify the global saturation 
or to give a tint. 




4.20.2. Usage 

Use the saturation slider to correct the global saturation. 

You can also draw an area on the color diagram to give a global tint to the image. 

4.21. Sharpen 
4.21.1. Overview 



This is an standard UnSharp Mask tool for sharpen the 
details of an image. 
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4.21.2. Usage 

4.22. Grain 
4.22.1. Overview 



This module is an artistic feature which simulates the 
grain of a film. 



4.22.2. Usage 

The grain is processed on the L* channel from CIELAB. 
coarseness 

Set the grain size, which has been scaled to simulate an ISO number. 
strength 

Set the strength of the effect. 
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Crop and rotate 



4.23. Crop and rotate 
4.23,1- Overview 



This module is used to crop, rotate and correct 
perspective of your image. It also includes many helpful 
guidelines that assist you using the tools. 




4.23.2. Usage 



First off, select what aspect ratio you want and size the crop bounds by dragging border and corner handles. Use 
ctrl-x or the button right to the aspect box, to swap between portrait and landscape of the cropping rectangle. You 
can move around the crop rectangle by holding down left mouse button and move around. When you are done and 
want to execute the crop, hit enter key or double click in the crop rectangle. TlP.hit "backspace" to reset the crop 
rectangle. 



Flip image 



Angle 



Use these toggle buttons to flip image horizontally and vertically. 



This is the rotation angle to correct, for example, a non-horizontal horizon. You can either type a numerical value 
or use your mouse directly on the image. To use your mouse, right-click, hold it down and draw a line along the 
horizon ; the image is then rotated so the line you drew matches the horizontal axis. 



Perspective 



Aspect 



Guides 



This tool is used to correct any perspective distortions in your image. Useful when you shoot an high building from 
ground, aiming upwards with camera with short focal length for example. 

You can also choose which direction (right and up) the correction should be applied on. 



Here you can change what aspect ratio you want to have on the result, thus constraining the ability to drag and crop 
rectangle out of the aspect ratio of your choice.. 

free free forming the rectangle without any ratio restrictions 

image this option constrains the ratio to be equal to image ratio 

golden cut this option constrains the ratio to be equal the golden number 

square this option constrains the ratio to be 1 



Many self-explaining guides are available to help you compose your image. 



4.24. Output profile 
4.24.1. Overview 



This module manages the output profile both for display 
and for output. 
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Channel mixer 



4.24.2. Usage 



You can set intent and profile for both display and output. You can go to "Input profile" to have details on the 
different available options. 



4.25. Channel mixer 
4.25.1. Overview 



This module is a powerful tool to manage channels. As 
entry, it manipulates red, green and blue channels. As 
output, it uses red, green, blue or gray or hue, saturation, 
lightness. 




4.25.2. Usage 

Select your output channel and then set the amount of each channel to feed the output channel. 

4.26. Local contrast 
4.26.1. Overview 



This module allows to enhance the local contrast. It 
uses CLAHE (Contrast Limited Adaptive Histogram 
Equalization). 



4.26.2. Usage 

Local contrast boosts the details of your image without changing the global contrast. 

radius 

Set the size of the region around pixels whose histogram will be equalized in order to boost contrast. This value 
must be greater than the size of the details to preserve. A small value limits the effect. 




amount 



Set the strength of the effect, by giving the allowable stretch in histogram, the greater the value, the stronger the 
effect. 



4.27. Velvia 
4.27.1. Overview 



The velvia module enhances the saturation in the image; 
it increases saturation on lower saturated pixels more 
than on high saturated pixels. 



O w velvia 
saturation 




— i 
< 15.00 % > 


3 


vibrance 




< 30.00 % > 




mid-tones 


bias 


< 25/75 > 





26 



Vignetting 



4.27.2. Usage 

Saturation 

This slider controls the strength of saturation for the effect. 
Vibrance 

Vibrance controls how much of the saturation is applied to weighted pixels. 

Mid-tones bias 

This slider controls saturation preservation in mid-tones. It is expressed as the lightness repartition between mid- 
tones and shadows/highlights. The greater the first number, the stronger the effect. 



4.28. Vignetting 
4.28.1. Overview 



This module is an artistic feature which creates 
vignetting (modification of the brightness/saturation at 
the borders). 




4.28.2. Usage 

The vignetting module has extensive parameters to precisely tune your effect. 
scale 

Set radii of the vignetting beginning. 
fall-off strength 

Set the progressiveness of the fall-off. 
strength 

Set the strength of the effect. 
uniformity 

Set the uniformity of the effect. 
b/s ratio 

Set the ratio of brightness and saturation the vignetting should apply on. 

saturation 

Invert the effect of saturation. By default the vignetting desaturates at the border. Using this button you can saturate 
it. 



fall-off 



Invert the effect of brightness. By default the vignetting darkens at the border. Using this button you can brighter it. 



27 



Splittoning 



4.29. Splittoning 
4,29.1. Overview 



Original splittoning method creates a two color linear 
toning effect where the shadows and highlights are 
represented by two different colors. In the example 
image below you can see an original black and white 
image and one where a splittoning effect are applied with 
blue in shadows and yellow-ish color in highlights. 




Darktable splittoning module has more parameters that impacts on the default above behavior, we have balance 
which offsets the 50% gray level in image and compression that does compress toning in the shadows and highlights 
which leaves a gap which are untouched by the effect. Read more and see examples of these additional parameters 
to splittoning module in "usage" section. 

The splittoning module does not convert image to black and white and works extensible nice on color images, soo 
if you want to do traditional splittoning, use the monochrome module to make the image black and white before 
playing around with splittoning effect. 



4.29.2. Usage 



Shadows and Highlights color 



These controls are used to set the color of the splittoning effect, you select the desire color and saturation for both 
shadows and highlights, you can also click the color preview box too bring up a common color picker dialog. 



Balance 



The balance is presented as an ratio bar and default value is 50/50 which means that 50% of lightness range in image 
are used for shadows toning and the other 50% for highlights toning. 



Compression 



Compression is a percentage of total lightness range that not is affected by color toning, default value is set to 33% 
which not is the default behaviour of a original splittoning which would be 0% compression. The choice of 33% as 
default is to invite you exprimenting with these parameters and how it extends the original splittoning method... 
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Examples 



5. Examples 

5.1. Cross-processing 

5.1.1. Overview 



Cross-processing is a analog processing technique where 
slide film (normally developped thanks to an E6 solution) 
is processed in chemicals used for processing print film 
(C41). The resulting images get skewed colors usually a 
cyan hue and increased contrast and saturation. 




The standard way for doing digital cross-processing is to use a channel curve tool but Darktable lacks this tool for 
the moment and another way to accomodiate the effect is used. 

5.1.2, Procedure 

This procedure uses tonecurve, channelmixer and splittoning modules. 

1. Image preparation 

Prepare the image for the cross process steps by adjusting the base settings such as exposure,whitebalance etc. 
for a correctly looking image. 

2. Boost contrast 

Select the medium contrast curve preset for tonecurve module to boost the overall contrast in the image. You 
later might get back here to tune the curve for better result. 

3. Colorcast 

This step does change the colorcast as the base for the effect using the channel mixer. You might later get back 
to this and finetune the colorcast of the final result. 

a. Enable the channel mixer module 

b. Select blue channel and set blue color value to 0.8 

c. Select red channel and change blue color value to 0.1 

d. Select green channel and change blue color value to 0.1 

4. Splittoning 

We use splittoning for add some more coloring to the result for cyan/blue shadows and yellow highlight. 

a. Enable the splittoning module 

b. Select a cyan/blue tone for shadows and set saturation around 50% 

c. Select a yellow/orange tone for highlights and set saturation around 70% 

d. Set compression to 10% 

e. Use the balance slider to tune the splittoning effect due this differs on every image due to it's exposure, motive 
etc. 
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Cyan toned image 



5.2. Cyan toned image 
5.2.1. Overview 



Cyan is a nice color touchup for black and white images, 
this example guides you through how to make this with 
Darktable and how to control the tone. You can choose 
any tone of your like for this tutorial... 
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5.2.2. Procedure 

This procedure uses tonecurve, channelmixer and splittoning modules. 

1. Image preparation 

Prepare the image for the cyan toned steps by adjusting the base settings such as exposure,black level, contrast 
etc. for a correctly looking image. 

2. Black and white 

Enable the monochrome module to make the image black and white. 

3. Add color tone 

This step selects the basetone of the image using channel mixer, we are going for cyan tone but you can choose 
the tone of your like here. 

a. Enable the channel mixer module 

b. Select red channel and set red color value to 0.7 

c. Select green channel and red color value to 0.150 

d. Select blue channel and red color value to 0.150 

As you notice we mix blue and green color to get a cyan tone, we substract 0.3 from red channel and add them 
to blue and green. 

4. Splittoning 

The result of previous step does also add a colorcast on highlight that we actually want to have white for a prettier 
result. We also wants to add some blue color cast to the shadows to emphasis them. 

a. Enable the splittoning module 

b. Select a blue/cyan tone for shadows and set saturation around 50% 

c. Set highlights saturation to zero, to remove saturation on highlights. 

d. Set compression to zero 

e. Use the balance slider to tune the effect, our example uses a balance of 70/30 
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Converting to Black and White 



5.3. Converting to Black and White 

5.3.1. Overview 

Black and white conversion can be achieved in several 
ways with darktable. Indeed, darktable comes with a lot 
of modules, especially for color manipulation. In this 
manual, I will show you 4 ways to perform a black and 
white conversion. 

5.3.2. The obvious way: monochrome module 

To perform such conversion, just activate the monochrome module. You can then simulate a color filter, by dragging 
the circle above the colours you want to filter. Filter size can be modified thanks to wheel scrolling. 

5.3.3. The simple way: color correction module 

To perform such conversion we use the color correction module. 

1 . Activate the color correction module 

2. Use the bottom slider to set saturation to zero 

5.3.4. The artistic way: color zones module 

To perform such conversion we use the color zone module. 

1 . Activate the colour zones module 

2. By default, the first radio-buttons row is set to "colorness" whereas the second is set to "hue" wich means 
that color are selected according to their hue (horizontal scale) and you can change for each hue its 
"colorness" (vertical scale). You simply need to set all points to the minimum of the vertical scale to de-saturate 
every hue. 

3. But now if you want, you can keep some hues a little bit saturated, so your image will be all black and white but 
some hue. A classical use for portrait is to keep red hue saturated in order to make the lips standing out. 

You can also use presets that perform black and white conversion, keeping some hues saturated. 

5.3.5. The sophisticated way: channel mixer module 

To perform such conversion we use the channel mixer module. 

1 . Activate the channel mixer module 

2. Select the gray output channel 

3. Set the proportion of each color, the sum having to equal 1 if you want to keep your global lightness. 
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